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ABSTRACT 

The aim of this thesis is to design and implement a 
graphic subsystem for a graphic display terminal with conic 
section capabilities. The display terminal with its associ- 
ated peripheral hardware is connected to a PDP-11/50 com- 
puter. 

The basic concents and design principles of graphic sys- 
tems are discussed. A brief description is given of the 
particular hardware configuration of the Conog raph i c - 1 2 

I 

display system as installed at the Naval Postgraduate 
School. Concepts incorporated in the designed implementa- 
tion are explained. Recommendations are included for possi- 
ble future extensions of the system's capabilities. 
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I. INTRODUCTION 

The purpose of this thesis is to desian and implement a 
graphic subsystem for a graphic display terminal with conic 
section capabilities. A literature search was performed to 
determine the desirable features of a graphic system and 
plausible means of implementation. The resulting i mp 1 e- 



ment ed 


design provides the applications orogrammer with a 


1 i b r a r y 


packaae of general ourpose subroutines which con- 


st rue t 


the commands for the Conoaraoh i c-1 2 Interactive 


Graphic 


Display System. 



The Conographic-12 Display System, as installed at the 
Naval Postgraduate School? is a display terminal interfaced 
with a PDP-11/50 comouter. The terminal system includes an 
alphanumeric keyboard? special program function keyboard? 
joystick? and extended symbol capability. This terminal 
draws points? straight lines? characters? circles? arcs? 
ellipses? and conic curves. As a result? major reductions 
in the amount of data reguired to draw a given picture are 
made possible. Data compression means that pictures take 
less CPU time to manipulate? significantly less storage 
SDace? and substatially less time to transmit from comouter 
memory to display aevice 131. 
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II 



interface DESIGN CONCEPTS 



A. UNIVERSAL GRAPHIC LANGUAGE 

One of the major obstacles in defining a aeneral graphic 
subsystem is that > even among the experts, there is no con- 
sensus of ooinion on what its capabilities should be. Many 
can point out various functions which they would like to see 
in the system, but each person desires different functions. 
The one point on which most do aaree is that, at this time* 
simplicity is more important than efficiency in a graphic 
language. Once a 1 anguaae has been conceived and can be 
used by a wide variety of oeoo 1 e , then the efficiency of the 
language can be extended. 

Wiseman says it is a mistake to say that "because we are 
dealing with graonical t h i n a s , there is a need to invent a 
new language/ or oerhaos to embellish an existina one" [4], 
what is needed is a rich 1 anguaae able to express and mani- 
pulate complex data structures. The task of generating pic- 
tures as a byproduct is easy? the complexity in graphics 
arises from the problems of data description and task coor- 
dination. 

William Newman claims we already have a general purpose 
graphic language in FORTRAN IV. M ost proposed graphics 
packages are based on FORTRAN IV, even thouoh it is not a 
particularly good lanauaae [ 61 . It nas to be considered 
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universal because everyone uses it [41. E x t r apo 1 a t i nq from 
this arguement anv 1 anguaqe with input/output capabilities 
could be considered a qeneral purpose graphic language if 
there are no particular requirements that it must meet. 

Several of the exoerts believe that it is impossible to 
define a universal araphics lanquage only because graphics 
is not understood well enouah. For instance/ we do under- 
stand arithmetic well enough so nobody questions the useful- 
ness of a universal arithmetic lanquaoe. Rosenfeld suggests 
that "we can inculcate graphical thinking at a stage as 
early as arithmetic thinkina is now inculcated/ and let the 
next generation desiqn the universal graphic 1 anguaqe "( 4 ] . 

Wells considers set theory a universal graphic 1 anguaqe. 
Unordered sets appear in many languages. The ordered struc- 
tures/ lists and arrays/ in oroaramming languages are just 
the sequences of set theory; the procedures are the func- 
tions of set theory; and lines are naturally considered to 
be sets of points. Reliance should be/ wherever oossible/ 
on established general mathematical symbolism and conven- 
•tions/ rather than considering particular extensions to 
c ompu t e r-or i en t ed languages that have been developed with 
economics of machine operation as a prime consideration. 
Lanauaaes should first be desianed for man-to-man 
communication/ with concern for the efficiency or implemen- 
tation on various machines cominq later 1^1 . 

Since there are different areas of graphics with 
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different requirements perhaps it would be more practical to 
define these areas and their requirements. The different 
areas of graphics include: off-line input/ recognition/ and 
scene analysis? interactive input/ plotting output/ line 
drawings? and shaded pictures. Most applications will be 
concerned primarily with one of these graphic areas although 
some applications may deal with a combination of areas/ such 
as the field of interactive design which uses a combination 
of interactive input and line drawings. The specific needs 
of each area should be researched and defined. Then a 
1 anquage can be designed for each area rather than attempt- 
ing to desian one language for all araphics areas. 



B. GOALS OF A GRAPHIC SYSTEM 

Graphic terminals are particularly well adapted fo the 
many problems which do not yield exact solutions bv a given 
algorithm. Such problems often require the user’s direct 
intervention at different stages in the computation/ man- 
to-machine dialogue/ in order to obtain satisfactory solu- 
tions. The efficiency of such a dialogue demands a rapid/ 
synthetic representation of results as well as a simple/ 
flexible/ and convenient means of intervention at the user's 
disposal. Graphic terminals allow quick visualization of 



d i ag r ams / 



graphs/ or any picture which would be far more 



easily interpreted than the usual tabulated numerical 
results. Moreover/ these terminals/ being eauioped with 
joystick/ hardware zoom/ and alphanumeric and function key- 
boards/ become accessible to non-orogrammers (21. 

Ease of use is one of the principal goals of a graphic 
system. Conseouent 1 y / a graphic system reouires certain 
properties. First/ concepts linked with the use of graphic 
terminals have to be clearly set aoart . These basic con- 
cepts must appear in the structure of the application pro- 
gram/ making the system a "guide for good programming" (2). 
Second/ the number of instructions related to interactive 
graphics should be as small as possible. The goal is to 
make the user's manual a handy reference guiae rather than 
an in-depth study. 

Few general purpose graphic systems would be able to 
satisfy completely all the reouirements of a particular 
application. Therefore. an applications programmer is 
freauently obliged to develop a specific system which con- 
tains the features needed to resolve his own particular 
problem. In the graphic subsystem for the Conog raph i c- 1 2 an 
attempt is made to provide as broad a variety of general 
purpose graphic tools as is needed to aive the applications 
programmer access to all of the terminal's capabilities. 
The modular nature of subroutine calls facilitates modifica- 
tion. This includes the deletion of functions which through 
utilization are determined to be non-useful/ as well as the 



addition of new functions which are deemed desirable 



For 



this reason, a 
c i ent means of 
tic extension 
Bou 1 1 i e r [21 . 



list of subroutine calls becomes a more effi- 
imDlementatinq an interface than the "syntac* 
of an existing language" recommended by 



C. SOFTWARE DESIGN 



The software suDDort required to utilize graphic devices 
such as the Conoq r aph i c - 1 2 , include machine-dependent 
transmission, interrupt handling routines, and processors 
for user-oriented lanauages. The design of graphic programs 
begins with an evaluation of other software support avail- 
able to the computer system and the decree of interaction 
required to incorporate the graphic devices 151. 

A multi-level design approach is used in the development 
of graphic software. There are generally considered to be 
four levels. Level one includes subroutines which are 
dependent on the hardware characteristics of the araphic 
device. They perform primitive operations. Software 
developed at this level provides the basic tools for pro- 
gramming at the higher levels. Level two programs comoine 
the facilities available from the operating system with the 
hardware-oriented procrams of level one. This combination 
provides the programs and user-oriented languages to be used 
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at level three. Software development at level three 
includes user-oriented subroutines which are capable of 
organizing buffer and file management routines/ and can for- 
mulate graphical instructions and data transmission. Level 
four progamming is application proqams which are directed 
toward the support of the non-proarammer t51 . 

The lowest level of this multi-level design is illus- 
trated in this project. It involves efforts to provide an 
efficient interface for the handling of signals between the 
computer and the graphic devices. Progressively higher lev- 
els of software components can then be developed to increase 
the productivity and utility of the total system. 

The programming activities of this project are primarily 
in the cateqory of level one software desiqn - primitive/ 
h a r dwa re -o r i en t ed subroutines. At the most primitive level/ 
subroutines are used to produce the object code which is 
required to generate images. Examples include code to plot 
a point/ display a character/ draw a vector/ etc. At this 
level all the parameters are device-oriented. That is/ the 
subroutines work with the parameters required by the 
Conograph i c- 1 2 . Using other subroutines/ the screen point 
coordinates and slope values are converted into the device- 
oriented curve parameters. User-oriented subroutines con- 



vert the user's coordinates to screen coordinates 



III. HARDWARE ENVIRONMENT 



The Conograohic-12 Interactive Graohic Display System 
includes raster scan CRT display/ alphanumeric keyboard/ 
program function keyboard/ joystick/ extended symbol capa- 
bility/ and hardware zoom. The coordinate system inherent 
in the hardware is an integer address soace with the x and y 
coordinate values ranging from -4096 to 4095. The hardware 
includes scale and offset registers which provide the c a o a - 
bility of varying the oortion of address space which is 
disDlayed on the screen. When the scale factor is one and 
the offsets are zero/ the x coordinates from zero to 2047 
and the y coordinates from zero, to 1536 are visible on the 
sc r een . 

The storage tube terminal has the basic capabilities of 
displaying vectors and alohanumeric characters. Once writ- 
ten the disolay remains visible until erased. It is not 
necessary to continually regenerate the output data or 
refresh the screen. The oicture is actually drawn on the 
target of a video memory utilizing random X-Y deflection. 
The target of the video memory is electronically scanned to 
produce the video signal which the raster scan CRT displays. 
The generator/ which supplies the X-Y deflection signals/ 
draws conic curves in response to digital oarameters sup- 
plied from a computer (31. 



The alphanumeric keyboard has the ability to generate 



all two hundred fifty-six 0-bit character codes. The key- 
board generates one hundred twenty-eiqht ASCII character 
codes> and there is an additional key to force the parity 
bit to zero or one. This extends the range of codes that 
may be generated to the full two hundred fifty-six. The 
alphanumeric keyboard can be enabled/disabled by a command 
from the user's proaram in the host computer. When enabled; 
striking a key generates an interrupt/ passing the keycode 
to the computer. For the operation of various additional 
keys provided on the keyboard/ reference the Conog r aoh i c - 1 2 
System Reference Manual t31. 

The proaram function keyboard consists of thirty-two 
function keys which produce codes that mav be interpreted by 
a program in the host comouter. The resulting action is 
totally dependent on the proaram. 

The joystick/ when enabled by a program/ provides cursor 
positioning control directly to the user. A program may 
obtain this Dositional information by reading the graphic 
disolay terminal's registers. Other information obtainable 
from the registers are: offset/ scale/ dash pattern/ dash 
frequency/ and selected intensity. 

The hardware zoom is completely independent of any pro- 
gram. It provides the user with the caoability of dynami- 
cally scaling and positioning the displayed picture in order 
to view a select oortion. 

The extended symbol caoability provides the possibility 
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of having specialized fonts or special sets of symbols for 
particular applications. A standard ASCII character font is 
provided. It is implemented in a 4K POM which is addressed 
as a particular range of the terminal's memory. When the 
terminal is in alphanumeric mode and an 8-bit character code 
is received, execution of the instructions located at the 



address indicated bv the 


sum of 


the 


contents of 


the 


font 


base register 


plus the 


the 


8-bit 


character code i s 


oe r- 


formed. In the 


standard 


ASCII 


character font 


ROM, 


t h i s 


first instruction is "jump to 


s ymbo 1 


subrout i ne" 


m . 


Thus 



the first 256 locations in the font's adoress space comprise 
a jumo table. The symbol subroutine is composed of short 
graonic commanas, 1 1 u s all capabilities of the terminal are 
accessafcle except the hardware dash pattern ana selectable 
intensity. All address ina within a font is relative to the 
value in the font base reaister. The address soace of a 
font is limited to ^096 locations starting with the address 
in the font base reaister t u ] . Special fonts and symbol 
sets may be implemented in the same manner as that just 
described for the stanoard ASCII character set. The partic- 
ular font to be utilized is selected bv setting the font 
base register. Tne default setting of the font base regis- 
ter is tne ASCII *ont. 



1 6 



IV. CONIE - CONOGRAPHIC INTERFACE EFFORT 



The Conograohic-12 Interface is a hierarchical set of 
subroutines which can be divided into four general areas: 
Direct Graphics* Virtual Graphics* A 1 ph anume r i c s * and Con- 
trol Routines. The routines in all these areas provide the 
user interface. This is where the functions as conceived by 
the user are translated into functions which are acceptable 
to the computer. To provide ease of use* every operation 
which is functionally different is referred to by a seperate 
subroutine call. Each subroutine call and its arguements 
are described in Aooendi x A of this thesis. 



A. INITIALIZING AND TERMINATING 



To ensure a prooer starting seauence* an initializing 
routine is provided and must be called before usina any 
other CONIE roufine. The initial state is defined by the 
following four reauirements: Cursor and beam are at the HOME 
posit iondower left-hand corner); Terminal is in qraphic 
mode* The scaling is set to unity and rotation and offset 
are at zero ; Character size is set to two* "normal" condi- 
tion. This initializing routine opens files* therefore* it 
must not be recalled prior to calling the terminating 
routine. The terminating routine closes the files. 



B. DIRECT GRAPHICS 



Direct oraohics utilizes the coordinate system provided 
by the Conoo r aoh i c - 1 2 hardware. Included are scalina and 
offsetting. The facilities for utilizing the conic section 
capabilities are orovided. These include routines to draw 
curves qiven the points and slopes uniquely describing the 
particular curve desired. Curves may be uniquely defined 
by: two points and their associated slope (see figure 1)* 
three ooints and the s 1 one associated with one of these 
points (see figures 2,3 and 4 ) * or three points where the 
slope at the intermediate point is equal to the slooe of the 
chord joining the endpoints (see figure 5). Also included 
are routines for drawinq circles* ellipses* and quarters 
thereof. These figures may be specified by their center and 
length of axes* or their center and one endDoint of each 
axis ( see f i gure 6) . 

C. VIRTUAL GRAPHICS 

To escape the size constraints of the terminal screen* 
the concept of virtual coordinates was implemented. The 
virtual coordinate system is an imaginary surface bounded 
only by the ranae of the floating ooint numbers of the com- 
puter system being used. The user may construct a drawing 
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FIG 3 




FIG 4 
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FIG 5 




FIG 6 
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in any section of the virtual coordinate system that is 
desired. The units of the system have no physical dimen- 
sions associated with them. Such a dimension may be arbi- 
trarily assumed at the user's convenience. Before con- 
structing the drawinq. the user specifies which portion of 
the virtual coordinates system to be viewed by callinq a 
rout i ne . 

The virtual coordinate system facilities are similar to 
those available with direct coordinates. There is one not- 
able exception: Virtual coordinates permit distortion - that 
is. the X and Y units may be of different sizes. This 
capability is not available with direct coordinates. The 
distortion capability precludes Dermitting lengths as param- 
eters for routines (see figure 7). Therefore, the routines 
available with virtual coordinates are only a subset of 
those available with direct coordinates. 



D. ALPHANUMERICS 

Capability is provided for sendinq a string of charac- 
ters. A character s t r i n a . as defined in the " C " lanquaqe 
[7]. is any number of characters, excludinq the null charac- 
ter. However. the null character must be included at the 
end of the string to indicate termination of the character 
string. A string of characters will normally be interpreted 
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FIG 7 
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by the Conograph i c- 1 2 as belonging to the ASCII character 
set» unless a different set of symbols has been defined and 
the font base register has been loaded to point to this 
other set of symbols. 

There are two modes for sendinq a string of characters 
to the terminal. The difference between Template Mode and 
Alphanumeric Mode is only a scale factor of eight? 
alphanumerics are drawn scaled down by a factor of eiqht. 

E. CONTROL ROUTINES 

There are various control routines which provide for 
such functions as re-initialization? erasure? ringinq the 
keyboard bell? selecting dash patterns and frequencies? and 
setting scale factor, angle of rotation, center of rotation, 
and reflection bits. Other control routines provide for the 
reading of the terminal's reaisters, keyboard characters! 
and the program function keys. A control routine which 
utilizes the recursive property of the " C " languaqe allows 
larqe complex structures to be built up in modular fashion 
from small simple structures 111. At the lowest level of 
complex structures! the extended symbol capaoilty can be 
utilized to further simplify the building of structures. 
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V. RECOMMENDATIONS 



An assembler or very oowerful editor for building 
extended symbol sets would be a very useful extension to the 
present implementation. This is needed to assist the pro- 
grammer in building the jumo table with the proper 
addresses . 

The addition of higher level routines to plot arrays* 
and to provide curve- f i t t i ng and data smoothing is recom- 
mended. The caoability of plotting arrays is convenient in 
a variety of 3Dpl icat ions. Cu r ve- f i t t i ng and data smoothing 
combine to take full advantage of the Conog r aph i c - 1 2 ' s capa- 
bilities so that data comoression can be fully exoloited. 

The different grachic disolay terminals at the Naval 
Postgraduate School have uniauely individual hardware 
features. However* in time the capabilities provided by 
their software systems will achieve a high dearee of over- 
lap. At that time it will be feasible to design and imple- 
ment a pre-orocessor extension to the " C " language f 7 1 which 
will perform the translation to the particular routines for 
the graohic disolay terminal selected at compile time. A 
program can then be written which can be executed on any or 
all of the different graohic disolay terminals simoly by 



recoup i 1 i ng (8] 



VI. CONCLUSIONS 



The Conographic-12 Interface Effort has been designed 
and implemented. As a result of the programming effort 
involved in the production of CONIE, the user can fully 
utilize the Conogr aoh i c - 1 2 and its associated peripheral 
hardware . 
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APPENDIX A - USER'S MANUAL 



A. INTRODUCTION 

This manual lists in alohabetical order the subroutine 
calls used for sending araohic commands to the Cono- 
graphic-12 terminal. Prior to the execution of a program 
utilizing these calls? the terminal should be turned on and 
placed in non-local mode utilizing the switch Drovided on 
the terminal's alohanumeric keyboard. 

The various graphic facilties available are curve draw- 
ing? scaling? offsettina? automatic dash pattern for draw- 
ing? reflections? variable intensity? and rotation. Also 
available is the ASCII character font and the capability of 
defining additional fonts. 

To utilize the various subroutines provided? a program 
is written usino costart () as the first graphic call and 
cgfiniO as the last. The oarticular picture or subpictures 
to be displayed are best described in functions defined by 
the user utilizina the drawing commands such as cgline? 
comove? cgelosa? or cgcr22. There are a variety of addi- 
tional drawino commands from which the user may select those 
best suited to his needs. Character outout intermixed with 
drawing commands can be accomplished simply by using the 
coal ph command. If the convention is followed of utilizing 
a seoerate function for each suboicture? then the posi toning 
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of each suboicture can be easily accomplished using commands 
like cgdrawr. This also simplifies the defining of subpic- 
tures since each has its own set of coordinate axes. Thus 
the user can define independent objects for display and 
later accomplish the relative oositioning. 

An illustration of how cgdrawr may be utilized is in the 
segmentation of a disday object into its component parts/ 
which may have their own symmetry. A simple example would 
be the wheel of a vehicle. For such a case a user would 
write a function defining a wheel/ oerhaps with coordinates 
(0/0) for the center hub of the wheel. The vehicle body 
could be defined in a seperate function with the coordinates 
(0/0) oossibly at one of the corners of the vehicle. When 
drawing the complete vehicle with wheels/ the seauence of 
camove followed with cgdrawr would be utilized. The call to 
camove would be used to Dosition the beam at the end of the 
vehicle's axle. The command cadrawr would be called with 
the wheel function and the proper coordinates of the wheel's 
center as defined by the wheel function as parameters. This 
would effectively place the wheel on the end of the 
vehicle's axle. 

The parameters of scale/ rotation/ and reflection for 
cadrawr provide additional flexibility. With the scale 
parameter available/ a user need not concern himself with 
making the units uniform for all suboictures. Instead he 
may utilize the most convenient units for each seperate 
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subDicture and then scale aoprooriately. The rotation 
parameter enables the user to define a subpicture at the 
angle where its coordinates are most easily expressed? and 
then rotate the subpicture to provide the proper display. 
The reflection parameter Drovides the capability for exact 
90 degree rotations and subpicture inversions. The center 
for all of these t rans f o rma t i ons is the beam position when 
the cgdrawr command is executed. 

Control of the manner in which input coordinate data is 
to be interpreted is provided by the subroutines cginpfm and 
cqvcord. The routine cainofm permits the user to declare 
whether his coordinate data will be expressed in normal 
Cartesian coordinate format or in coordinates relative to 
the beam position. The routine cgvcord enables the user to 
specify a floating point coordinate system. The information 
the user provides cqvcord is used to set the parameters 
necessary for convert ina float inq point coordinates into the 
integer coordinate system of the screen. 

Additional subroutines orovide control of various 
hardware features? some of which are as simple as ringing 
the keyboard bell. Others orovide the innut of information 
from the various auxiliary devices? including the 
alphanumeric and program function keyboards. The dash pat- 
tern and selectable intensity are controlled by the routines 
cadofis and cadsi. The routine cadpfis is utilized to set 
the pattern and intensity available. The routine cadsi is 
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inserted at aoDrooriate places in the drawing commands to 
turn on or off the utilization of the dash pattern or 
selected intensity. The ability to erase either the full 
screen or a select object is provided by cgerase. In order 
to erase a particular object/ cqerase is called for the 
appropriate setting. The commands for drawing the object 
are the re-executed to accomplish the erasure/ after which 
cgerase is recalled to reset to normal drawing. 

The user's program is compiled/ specifying that the 
Conographic-12 library be included. The routines available 
in this library and the parameters they reguire are detailed 
on the following pages. The naming convention followed is 
that all start with the letters "eg” so that the user can 
easily avoid collision of names. Also all routines using 
virtual coordinates start with "cov" to signify that their 
coordinate parameters are virtual and must therefore be 
floating point numbers. 



B. SAMPLE PROGRAM 



// This program draws a simole sketch of a ferris wheel 

// This function defines the labels to be placed on each car 
char * num ( i 1 
i n t i ; 

{ 

sw i t c h ( i ) { 

case 0: return! "0"); 

case l: return!" 1"); 

case 2: return!"2"); 
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case 

case 

case 

case 

case 

> 



3: return("3") 
a: returned) 
5: return("5") 
6: return ("6") 
7: return("7") 



//This function draws the car and calls the label function 
c a r ( i ) 
i nt i ; 

{ 

ege i rc ( 0 , 0 , 5) ; 
cgelpsa(0,-50, 0.0,20,50) ; 

cgmoveC-5,-80); // Position for the label 

ega 1 ph ( num ( i ) ) ; // Outout the label 

> 



i nt i ; 

// This function draws the arms of the ferris wheel 
// and oositions the cars at their ends 
a rm ( a , b ) 
i nt a , b Z 

cgelpsa(0,0,0.0,a,b); 

cgmove(a^O); // Move to the end of the arm 

cgdrawaO .0,0. 0/0, 0,0, car, i ,0); 

// Set an upriqht orientation for the car 

> 

// This is the main oroqram which initiates and 
// positions the oicture on the screen 
ma i n ( ) 

< 

cqstart ("ferris"); 
ege r s r ( 0 ) ; 
cqmovet 1023,800); 

for(i=0;i<8;i++) cqdrawr(1.0,0.39269,i,0,0,arm,500,50) 

// Draw the arm in all its eiqht reflections 
c g f i n i ( ) ; 

> 
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cqa 1 ph 



cqa 1 ph 



NAME: 

c g a 1 p h • emit character string in alphanumeric mode 

SYNOPSIS: 

caa 1 ph ( a ) 
char at]; 



DESCRIPTION: 

This routine places the terminal in alphanumeric 
mode and then sends a character string to the terminal. 
It returns the beam position to a point one line down 
from the previous position and returns the terminal to 
the previous graphic mode. 

a - nu 1 1 - 1 e r m i na t ed character string to be sent to 
Conograohi c - 1 2 



SEE ALSO: 
cgto 1 t 
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cabe 1 1 



cgbe 1 1 



name : 

cgbell - ring keyboard bell 
SYNOPSIS: 
cgbe 1 1 ( ) 



DESCRIPTION: 

This routine rings the keyboard bell. 
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cqc i rc 



cqc i rc 



NAME: 

cgcirc - draw a circle 

SYNOPSIS: 

cqc i rc ( a > b , t ) 
i nt a / b / t ; 



DESCRIPTION: 

This routine draws a circle when given the center 
point and the radius. The coordinates of the center 
point are shown by a»b. The radius is defined by the 
value of t . 

a x coordinate of center 
b - y coordinate of center 
t - radius of circle 



SEE ALSO: 
cgc i rq 
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cqc i rq 



cqc i rq 



NAME : 

cgcirq - draw circle quarters 
SYNOPSIS: 

cqci rq(a,b,dr,q,se) 
int a»b,dr,g; 
float *se? 



DESCRIPTION: 

This routine draws auarters of circles when given 
the values for the center point, a point on the circle, 
the direction in which to draw from this point, and the 
number of quarters to be drawn. The present position of 
the beam defines a point on the circle. The center 
point is given by the coordinates a,b. The direction in 
which to draw from the present position is defined bv 
dr. The number of quarters to be drawn is shown by q, 
where one quarter is assumed and 3 draws a full circle. 
The address where the value of the ending slope will be 
returned is defined by se. 

a x coordinate of center 

b y coordinate of center 

dr - direction of drawing 

0 : draw clockwise 

l: draw counterclockwise 

q - number of additional quarters 

0: one quarter only 

1 : sem i -c i rc 1 e 

2 : two additional quarters, total three quarters 

3: full circle 

se - address of floating point variable where endinq slope 
can be returned 



SEE ALSO: 

\ 

caci rq 
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cgc r s r 



cqcrsr 



NAME: 

cgc rs r - turn cursor on or off 

SYNOPSIS: 

cgc rsr Co) 
i nt o? 



DESCRIPTION: 

This routine enab 1 e s /d i s ab 1 e s the joystick. tohen 
enabled* the user can directly control the positioning 
of the cursor by manioul at inq the joystick. 

o - action flag 

0: disable the joystick 

1: enable the joystick 



SEE ALSO: 
cardcsr 
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cgc r22 



cgc r22 



name: 

cgc r22 - draw a curve given 2 points and 2 slopes 

SYNOPSIS: 

cgc r 22 ( x * y * sb * se ) 
i n t x * y ; 
float sb * se * 



DESCRIPTION: 

This routine draws a curve when given two points on 
the desired curve and the slopes associated with these 
two ooints. The beginning point of the curve is the 
present position of ♦‘he beam. The coordinates x*y 
define the endooint. The slooe 0* the beginning point 
is defined by sb. The slooe of the endpoint is given by 
se . 



x x coordinate of the endooint 

y y coordinate of the endooint 

sb - slooe of the curve at the beginning point 

se - slope of the curve at the endpoint 



DIAGNOSTICS: 

The ambiguous case of Darameters sb=se outputs a 
message to the standard output* moves to the specified 
endpoint* and returns a negative value. 

SEE ALSO: 

cocr3b* cgcr3e* cgcr3i* cgcr3m, cgvcr22* cavcr3b* 
cgvcr3e* cgvcr3i* cgvcr3m 
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cac r3b 



cac r3b 



NAME: 

cgcr3b - draw a curve given 3 points and beginning slope 
SYNOPSIS: 

cac r 3b (g / h , x , y , sb / se ) 
i n t g , h , * , y ; 
float sb # *se J 



DESCRIPTION: 

This routine draws a curve when given three points 
and the slope at the beainninq point. The beginning 
point is defined by the present position of the beam. 
The coordinates of the intermediate point are given by 
g/h. The endooint is shown by the coordinates x/y. The 
slope at the beginning point is defined by sb. The 
address where the value of the ending slope will be 
returned is shown by se. 

g x coordinate of intermediate point 

h y coordinate of intermediate point 

x x coordinate of the endpoint 

y y coordinate of the endpoint 

sb - slope of the curve at the beginning point 

se - address of floating point variable where ending slope 

can be returned 



DIAGNOSTICS: 

If the parameters describe a curve with an 

inflection point/ a message is output to the standard 
output/ the beam is moved to the endpoint/ ana a 
negative value is returned. 

SEE ALSO: 

cqcr22/ cqcr3e/ cocr3i/ cqcr3m/ cove r22 , cqvcr3b/ 
cgvcr3e/ cqvci*3i / covcr3m 



38 



cgc r 3e 



c qc r 3e 



NAME: 

cgc r3e • draw a curve qiven 3 points and ending slooe 
SYNOPSIS: 

cgcr3e(q*h*x*y*se) 
int g* h * x * y ; 
float se; 



DESCRIPTION: 

This routine draws a curve when given the 
coordinates of three points and the slope at the 
endpoint. The beginning point is defined by the present 
position of the beam. The intermediate point is shown 
by the coordinates g*h. The endpoint is defined by the 
coordinates x*y. The slope at the endpoint is given by 
se . 

g x coordinate of intermediate point 

h y coordinate of intermediate point 

x x coordinate of the endpoint 

y y coordinate of the endpoint 

se * slooe of the curve at the endpoint 



DIAGNOSTICS: 

If the parameters describe a curve with an 
inflection point* a messaqe is output to the standard 
output* the beam is moved to the endpoint* and a 
negative value is returned. 



SEE ALSO: 

cgcr22* cgcr3b* cacr3i* cqcr3m* cavcr22* cavcr3b* 
cgvcr3e* c a v c r 3 i * cavcr3m 
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cgc r3i 



cgc r 3 i 



NAME: 

cgc r 3 i ~ draw a curve given 3 points and intermediate 
s 1 ooe 

SYNOPSIS: 

c gc r 3 i ( g , h , x , y , s i >se) 
i n t g > h , x , y ; 
float s i t * se ; 



DESCRIPTION: 

This routine draws a curve when given three points 
and the slope at the intermediate point. The beginning 
point is defined by the present position of the beam. 
The intermediate point is given by the coordinates g>h. 
The endooint is defined by the coordinates x,y. The 
slope at the intermediate point is given by si. The 
address where the value of the ending slope will be 
returned is shown bv se. 

g x coordinate of intermediate point 

h - y coordinate of intermediate point 

/ 

x - x coordinate of the endpoint 

y y coordinate of the endpoint 

si - slope of the curve at the intermediate point 

se - address of floating ooint variable where endinq slope 

can be returned 



DIAGNOSTICS: 

If the oarameters describe a curve with an 

inflection point* a message is output to the standard 
output* the beam is moved to the endpoint* and a 
negative value is returned# 

SEE ALSO: 

eg cr22f cgcr3b* cccr3e* cqcr3m* cq vcr22* cgvcr3b* 
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cavcr3er cgvcr3i, cgvcr3m 



cqc r 3m 



cqc r 3m 



NAME: 

cgcr3m - draw a curve qiven 3 points with the 
intermediate at the relative maximum 

SYNOPSIS: 

cgcr3m(g,h,x,y,se) 
int g , h , x > y ; 
float *se » 



DESCRIPTION: 

This routine draws a curve when qiven three points 
where the slope at the intermediate point is equal to 
the slope of the chord joining the endpoints. The 
beginning point S is defined by the present position of 



the beam. 


The intermediate 


point 


i s 


s h own 


by 


the 


coordi nates 


g r h. The endpo i nt 


i s 


defined 


by 


the 


coordi nates 


x , y . The address 


where 


the 


value 


o f 


the 



ending slope will be returned is shown by se. 
g x coordinate of intermediate point 

h y coordinate of intermediate point 

x x coordinate of the endooint 

y y coordinate of the endooint 

se - address of floating point variable where endina slope 
can be returned 

SEE ALSO: 



cgc r 22 , 


cgc r 3b > 


cacr3e» cqc r 3 i , 


cgvc r22 , 


cqvcr3bf 


cavcr3e> 


cq vc r 3 i , 


cq vc r 3m 







cgdo f i s 



cgdp f i s 



NAME: 

cgdpfis - set dash pattern and frequqncy and selectable 
i n t en s i t y 

SYNOPSIS: 

cgdpf i s(p, f , i ) 
i n t p , f , i ; 



DESCRIPTION: 

This routine sets dash pattern, dash frequency, and 
selected intensity level. Draw commands are affected 
only if cgdsi has been called setting dash and/or 
intensity select. 

0 - 12 bit value definino dash pattern, 1 specifies 

intensification and 0 specifies blanking; for example, 
07777 would be a solid line, 0 would be a blank line, 
0525 2 would be short dashes, 077 would be Iona dashes. 

f 4 bit value (0-15), this controls the frequency of 

the dash oattern thus determining the length of the dash 
corresponding to each bit in the pattern (note: other 

scale factors do not affect the dash oattern) 

1 - A bit value (0-15), sets the grey scale level of the 

selectable intensity, 0 is dimmest, 15 is briahtest, and 
12 is the grey scale level of the normal intensity 



SEE ALSO: 



cgdsi 



cgdrawa 



cgdrawa 



NAME: 

cgdrawa - set new orientation for user function 
SYNOPSIS: 

cgdrawa(s?a?r?x?y?f,ac?av) 
int(*f)()>ac/av/r»x,y; 
float s ? a ; 



DESCRIPTION: 

This routine resets the orientation then calls the 
user's function with the two arauements. Scaling is by 
means of the Conog raph i c - 1 2 hardware registers therefore 
limited to the range of 1/64 to 63 63/64. Upon return 
the previous orientation is restored. The user's 
function f is defined by the user to draw whatever 
subpicture he desires. The parameters ac and av are 
passed to the user's function so that it may have 
Darameters. If more than two parameters are desired? or 
non-integer parameters are desired? the two parameters 
provided can be used to pass a count and a pointer to an 
array of parameters. 

s - scale to be applied 

a - angle of desired rotation expressed in radians 

r - reflection desired 

0: no reflection 

1: reflect about x-axis 

2: reflect about y-axis 

3: reflect about both axes? (oi rotation) 

4: reflect about pi/4 line 

5: oi/2 rotation counterclockwise 

6: oi/2 rotation clockwise 

7: reflect about 3/4 oi line 

x - x coordinate which will correspond with oresent beam 
position and be the center of reflection and rotation 

y - y coordinate which will 

position and be the center 



f 



user defined function 



correspond with present beam 
of reflection and rotation 



ac - first arauement for user function 
av - second arquement for user function 



SEE ALSO: 



cgdrawr; cgvdrwa* cqvdrwr 



cqdrawr 



cgdrawr 



NAME: 

cqdrawr - set orientation relative to present 
orientation 

SYNOPSIS: 

cgdrawr(s>a»r>xc»yc»f >ac>av) 
int (*f)()»ac»av»r,xc»yc; 
f 1 oat s* a; 



DESCRIPTION: 

This routine sets a new orientation relative to the 
present orientation then calls the user's function. 
Thus the reflections* rotations and scalinq are 
cummulative. F or best results it is recommended that 
most scalinq factors be_ 1* if the hardware scaling 
provided here is insufficient it is recommended that 
virtual coordinates be utilized. Upon return the 
present orientation is restored. The user's function f 
is defined by the user to draw whatever subpicture is 
desired. The parameters ac and av are passed to the 
user's function so that it may have parameters. If more 
than two parameters are desired* or non-integer 

parameters are desired* the two parameters provided can 
be used to pass a count and pointer to an array of 
oa r ame t e r s . 

s - scale to be aoolied 

a - angle of desired rotation expressed in radians 

r - reflection desired 

0 : no reflection 

1: reflect about x-axis 

2: reflect about y-axis 

3: reflect about both axes* (oi rotation) 

4: reflect about Di/4 line 

5: pi/2 rotation counterclockwise 

6: oi/2 rotation clockwise 

7: reflect about 3/4 pi line 

x x coordinate which will correspond with present beam 

position and be the center of reflection and rotation 

y “ y coordinate which will correspond with present beam 



position and be the center of reflection and rotation 
f - user defined function 
ac - first arguement for user function 
av ” second arguement for user function 

SEE ALSO: 



cgdrawa» cgvdrwa* cavdrwr 



cgds i 



cgds i 



NAME : 

cqdsi - select dash and/or intensity 

SYNOPSIS: 

cgds i (d > i ) 
i n t d t i ; 



DESCRIPTION: 

This routine determines whether susequent drawing 
commands are to be dashed and/or at normal or selected 
intensity. This routine, is used in conjunction with 
cgpdfis which sets the particular pattern and/or 
intensity which is used. 

d * drawinq mode selection 

0: set solid drawina 

1: set dashed drawinq 

i - intensity selection 

normal intensity (12) 

the presently set selectable intensity 



SEE ALSO: 



0 : utilize 

1 : utilize 



cgpd f i s 



cge 1 osa 



cge 1 osa 



NAME: 

cgelpsa - draw an ellipse given center and axes lengths 
and orientation 

SYNOPSIS: 

cge1psa(a#b#r#mj »ipn) 
int a # b # m j # m n » 
float r ; 

DESCRIPTION: 

This routine draws an ellipse when aiven the center 
point# lenqths of the two axes# and the orientation. 
The center do int is given by the coordinates a#b. The 

length of the major semi-axis is defined by maj. The 
length of the minor semi -axis is defined by min. For 
orientation# the anale between the major axis and the 
horizontal is given by r and is written in radians. 

a - x coordinate of center 

b - y coordinate of center 

r - angle of major axis orientation with resoect to the 
x-axis expressed in radians 

mj - major semi-axis length 

mn - minor semi-axis length 



SEE ALSO: 

cgelpse# cgelosa# cgvelog 



cge 1 ose 



cge 1 pse 



NAME: 

cgelpse ~ draw an ellipse given center* one axis end and 
other axis 1 engt h 

SYNOPSIS: 

cgelose(a*b*xe»ye* la) 
int a*b*xe*ye»lg; 



DESCRIPTION: 

This routine draws an ellipse when given the center 
ooint* one axis endpoint and the length of the other 
semi-axis. The center point is shown by the coordinates 
a*b. The coordinates of the axis endpoint are given by 
xe» ye. The length of the other semi-axis is given by 
lg. 



a - x coordinate of center 

D - y coordinate of center' 

x - x coordinate of one semi -axis endpoint 

y - y coordinate of one semi-axis endpoint 

lg - length of other semi-axis 

SEE ALSO: 

cgelpsa* cgelosa* cgvelpa 
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cge 1 psq 



cge 1 psa 



NAME: 

cge 1 psq - draw ellipse quarters 
SYNOPSIS: 

cgelpsq(a*b*xe*ye*q*se) 
int a/b/xe^verq; 
float *se i 



DESCRIPTION: 

This routine draws the specified number of quarters 
of an ellipse defined by its center and one endooint of 
each axis. The ending slooe is returned in se. Present 
beam position is taken as the endooint of one axis and 
drawing starts .in the direction of the other axis 
endoo int. 

a x coordinate of center 

b - y coordinate of center 

xe - x coordinate of other axis endooint 

ye - y coordinate of other axis endooint 

g - number o f additional quarters 
0: one Quarter only 

1: semi -ellipse 

2: two additional quarters* total three quarters 

3: full ellipse 

se - address of floating point variable where ending slope 
can be returned , 



SEE ALSO: 

cqelpsa* cgelose* cqvelpq 



SI 



cge rase 



cgerase 



NAME: 

cgerase - erase screen 

SYNOPSIS: 

cge r ase C e * w ) 
i n t e t w ; 



DESCRIPTION: 

This routine erases the screen. There are two means 
of doing this. Full screen erase or a selective erase 
can be used. In a selective erase the item to be erased 
is redrawn after this routine is called to effect the 
erasure. 

e - erase screen f 1 aa 

0: do not full screen erase 

1: full screen erase 

w - writ ting mode flag 

0: return in normal writting mode 

1: return in selective erasure mode 
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c a f i n i 



caf i n i 



NAME: 



c g f i n i - close files 



SYNOPSIS: 



eg f i n i ( f n ) 
char f n [J ; 

DESCRIPTION: 

This rout i ne 
fn - filename used 

SEE ALSO: 



closes all 
previously 



files that 
when c a 1 1 i 



cgstart 



S3 



cgstart opens, 
ng cgstart 



cqhome 



cahome 



NAME: 

cghome - initialize 
SYNOPSIS: 
cahome ( ) 



DESCRIPTION: 

This routine oerforms display initializat 
cursor in lower left-hand corner of screen* 
size=2> picture scale=l* and rotation ang1e=0. 
are zeroed and terminal is in graphic mode. 



SEE ALSO: 
cgst art 



ion with 
character 
Offsets 
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cgi nofm 



eg i np f m 



NAME: 

cginpfm - set input form 

SYNOPSIS: 

cgi nDf m Co ) 
i n t o ; 



DESCRIPTION: 

This routine sets the mode in which coordinate 
parameters will be expressed. They may be expressed in 
either Cartesian coordinates (absolute) r where 

coordinates are relative to a fixed oriain, or in 
relative coordinates/ where the beam position is used as 
the origin so that adjusting one point also adjusts all 
subsequent points. 

o * selection indicator 

0: absolute coordinates 

1: relative coordinates 
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cqkbd 



cgkbd 



NAME: 

cqkbd ” enable/disable keyboard 

SYNOPSIS: 

cqkbd Ce ) 
i n t e ? 



DESCRIPTION: 

This routine turns the alphanumeric keyboard on and 
off. It is automatically called by cqrdkey to turn the 
keyboard on? however, the user must utilize this call if 
he desires the keyboard d i sab 1 eda f t e r reading. 

e - action flaa 

0: disable keyboard 

1: enable keyboard 



SEE ALSO: 
cgrdkey 
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cq 1 ine 



i ne 



cal 



NAME : 

cal ine - draw a line 

SYNOPSIS : 

c g 1 ine(x»y) 
i n t x / y ; 

DESCRIPTION: 

This routine draws a line from the Dresent position 
of the beam to the endooint defined bv the coordinates 
x , y . 



X 


x coordinate 


o f 


the 


endpo i n t 


y 


y coordinate 


o f 


the 


endoo i n t 



SEE ALSO: 
cgv 1 ine 
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cgmo ve 



cgmo ve 



NAME : 

cqmove - position cursor 

SYNOPSIS: 

cgmo ve C x , y ) 
i n t x , y ; 

DESCRIPTION: 

This routine moves the beam to the 
position without drawina. 

x - x coordinate of the endpoint 

y y coordinate of the endooint 

SEE ALSO: 
eg vmove 



indicated 
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cgpf k 



cgpfk 



NAME: 

cgpfk - enable/disable program function keys 

SYNOPSIS: 

cgpfk Ce) 
i nt e ; 



DESCRIPTION: 

This routine turns the proqram function keyboard on 
and off. It is automatically called by cgrdpfk to 
enable the function keys* but must be called by the user 
when he desires to diable the function keys. 

e - action flag 

0: disable o roq r am _ f unc t i on keys 

1: enable program function keys 



SEE ALSO: 
cqrdpf k 
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cgpoi nt 



cgoo i nt 



NAME : 

cgpoint - draw a point 

SYNOPSIS: 

cgoo i nt ( x , y ) 
i n t x , y ; 

DESCRIPTION: 

This routine draws a point at the specified 
pos i t i on . 

x - x coordinate of the point 

y - y coordinate of the Doint 

SEE ALSO: 
cgvpoint 
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cardacc 



cgrdacc 



NAME: 

cgrdacc - read accumulator 

SYNOPSIS: 

eg rdacc ( ac ) 
i n t * a c / 

DESCRIPTION: 

This routine reads the Conoaraph i c~ 1 2 accumulator. 

ac " address of an i nteoer variable where the value from 
the accumulator can be returned 

SEE ALSO: 
egrdreg 
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cardc s r 



cgrdcsr 



NAME: 

cgrdcsr - read cursor position 

SYNOPSIS: 

eg rdc s r ( x , y ) 
i n t * x t *y ; 



DESCRIPTION: 

This routine reads the Conoo r aoh i c - 1 2 present cursor 



POS i t i on . 


An 


additional 


side effect is that 


the cursor 


is turned 
re ad i ng . 


off 


prior to 


r e a d i n g 


and 


turned 


on after 


* - address 


o f 


an i nteaer 


variable 


where 


the x 


coord i nate 


can be returned 










y - address 


o f 


an integer 


v a r i ab 1 e 


where 


the y 


coordinate 



can be returned 



SEE ALSO: 

egersr, egrdreg 
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ca rdds w 



cgrddsw 



NAME : 

cqrddsw * read display status word 

SYNOPSIS: 

cgrddsw(ds) 
i n t *ds J 



DESCRIPTION: 

This routine reads the Conoaraphic-12 display status 
word. 

ds - address of an integer variable where the value from 
the display status word can be returned 

The bits have the following meanings (low order bit 0) 

0 : italics 

1: machine check 

3: pfk reauesting attention 

7,6: mode of the display 

00 - alphanumeric 

01 - template 

10 - short graph i c 

11 - long graphic 

10-8: reflection state 

11: graphic input flag 

15: TTY switch setting 



SEE ALSO: 
cgrdreg 
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ca rd f b s 



cgrdf bs 



NAME: 

cgrdfbs - read fort base 

SYNOPSIS: 

cgrdf bs ( fb ) 
i n t * f b ? 

DESCRIPTION: 

This routine reads the address in the font base 
register for the memory o * the Conographic-12. 

fb - address of an inteaer variable where the address from 
the font base register can be returned 

SEE ALSO: 

cgrdmem, cgwrmem, cordrea 
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cqrdkey 



cgrdkey 



NAME: 

cgrdkey - read keyboard characters 

SYNOPSIS: 

cgrdkey ( k ? n ) 
i nt n ; 
char * k ; 



DESCRIPTION: 

This routine reads a specified number of 
from the Conoqraph i c* l 2 alphanumeric keyboard 

n - number of characters to be read 

k - character array of at least size n where 
can be returned 

SEE ALSO: 

cgkbdf c'qrdreg 



characters 



characters 
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cgrdmem 



eg r dmem 



NAME : 

cgrdmem - read memory 

SYNOPSIS: 

C g rdmem ( b > n , w ) 
i n t b t n , * w ; 

DESCRIPTION: 

This routine loads tne font base register with the 
suDolied value and reads the specified number of words 
from memo r y . 

t> - value to be loaded into the font base register 

n - number of words to be read? this is limited to the 

range zero to 4096 

w - array of at least size n where the words from memory 
can be returned 



SEE ALSO: 

cgwrmem, cgrdfbs » cardrea 
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cgrdo f f 



cgrdo f f 



NAME : 

cgrdoff - read offset 

SYNOPSIS: 

cgrdo f f ( x , y ) 
i nt *x / *y ? 



DESCRIPTION: 

This routine reads the current Conographic-12 
offset . 

x - address of an inteoer variable where the x coordinate 
can be returned 

y - address of an integer variable where the y coordinate 
can be returned 



SEE ALSO: 
cgrdreg 
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cgrdp f k 



cgrdp f k 



NAME : 

cgrdpfk - read program function keys 

SYNOPSIS: 

cgrdpf k ( k , n) 
i n t n ; 
char * k } 



DESCRIPTION: 

This routine reads a specified number of keycodes 
from the Drogram funtion keyboard. 

n - number of keycoaes to be read 

k - character array of at least swe n where keycodes can 

be returned 



SEE ALSO: 

capfkr cqrdrea 



/ 
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cgrdreg 



cgrdreq 



NAME: 

cgrdreg - read all the registers 
SYNOPSIS: 
cgrdreg ( ) 



DESCRIPTION: 

This routine reads all the Conooraphic-12 registers 
into the array cgreo. They are arranged in the 
following order: 

0: x position 

1: y oosition 

2 : x offset 

3: y offset 

4 : object scale 

5: oicture scale 

6: qraohic scale 

7: font base register 

8: display status word 

9 : ac c umu 1 a t o r 



SEE ALSO: 

cgrdcsr/ cgrdoff* cgrdscl/ cgrdfbs/ cqrddsw, cgrdacc 
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cgrdsc 1 



cgrdsc 1 



NAME: 

cqrdscl - read scales 

SYNOPSIS: 

cgrdsc 1 (p> o » g) 
i n t *D(*o»*gl 



DESCRIPTION: 





This routine reads the scale registers of 
Conograph i c- 1 2 . 


the 


p 


- address of an integer variable 

the picture scale register can be 


where the 
returned 


value 


from 


0 


• address of an integer variable 

the object scale register can be 


where the 
returned 


value 


from 


g 


- address of an integer variable 

the graphic scale register can be 


where the 
returned 


value 


f r om 



SEE ALSO: 
cgrdreg 
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cqs tart 



cgs t a r t 



NAME : 

cgstart - open files and initialize 

SYNOPSIS: 

cgst art ( f n) 
char f n f] ; 



DESCRIPTION: 

This routine must be called prior to any other. If 
the parameter fn is present > an outDut file is created 
of the display commands that follow? otherwise the files 
associated with the Conograph i c- 1 2 are opened. 
I n i t i a 1 i za t i on performed by this routine is identical to 
that done by cahome. 

fn - filename of file to be created vice writing to the 
Conograoh i c - 1 2 



SEE ALSO: 

cahomef cafini 
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cat p 1 1 



cqtpl t 



NAME: 

c g t o 1 t • emit character strinq in template mode 

SYNOPSIS: 

cgtol t (a) 
char all I 



DESCRIPTION: 

This routine places the terminal in template 
and then sends a character string to the terminal, 
returns the beam position to a ooint one line down 
the previous nosition and returns the terminal to 
previous oraphic mode. 

a * nul 1-terminated character string to be sent 
Conograohic-12 



SEE ALSO: 
cqa 1 oh 



mode 

It 

from 

the 



t o 
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cgvcord 



cgvcord 



NAME: 

cgvcord - define virtual coordinates 
SYNOPSIS: 

cgvcord(lx,1y,rx,ry,d) 
i nt d? 

float t 1 y» rx » ry j 



DESCRIPTION: 

This routine defines the virtual coordinates by 
SDecifing the lower-left point of the screen and the 
uDoer-right point of the screen. Virtual coordinates 
are still affected by seal ina and offset. Definition of 
the virtual coordinates with respect to the screen 
assumes a unity scaling and zero offset. 



1 x - 


minimum 


X 


v i r t ua 1 


coordinate 


on 


the 


screen 


1 y - 


mini mum 


y 


v i r t ua 1 


coordi nate 


on 


the 


sc reen 


r x - 


max i mum 


X 


v i rt ua 1 


coordi nate 


on 


the 


screen 


ry - 


maxi mum 


y 


v i r t u a 1 


coordinate 


on 


the 


screen 



d - distortion f 1 ao 

0: do not distort 

1: oemit distortion 
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cgvc r22 



cgvc r 22 



NAME : 

cqvcp 22 - curve given endDoints and slooes 
SYNOPSIS: 

cgvcr22(x,y,sb,se) 
float x , y , sb » se ; 



DESCRIPTION: 

This routine draws a curve when given two points on 
the desired curve and the slooes associated with these 
two points. The beqinnina ooint of the curve is the 
present Dosition of the beam. The coordinates x,y 
define the endpoint. The si one of the beginning point 
is defined by sb. The slope of the endooint is given by 
se . 



x x virtual coordinate of the endpoint 

y y virtual coordinate of the endpoint 

sb - slope of the curve at the beqinnina point 

se - slope of the curve at the endpoint 

SEE ALSO: 



cac r 22 , 


ege r 3b > cac r 3e » 


cac r 3 i , 


cac r 3m , 


cgvc r 3e r 


cave r 3 i , 


cgvc r 3m 









Id 



cgvc r 3b 



cgvc r3b 



NAME : 

cgvcr3b - curve given three points and beginning slope 
SYNOPSIS: 

cgvcr3b(g,h,x/y,sb»se) 
float g/ h , x , y , sb > * se? 



DESCRIPTION: 

This routine draws a curve when given three points 
and the slope at the beainning point. The beginning 
point is defined by the present position of the beam. 
The coordinates of the intermediate point are given by 
g/h. The endpoint is shown by the coordinates x,y. The 
slope at the beginning point is defined by sb. The 
address where the value of the ending slope will be 
returned is shown by se. 

g - x virtual coordinate of intermediate point 

h y virtual coordinate of intermediate point 

x x virtual coordinate of the endpoint 

y y virtual coordinate of the endpoint 

sb - slope of the curve at the beainning point 

se ~ address of floatina point variable where endina slope 
can be returned 



SEE ALSO: 

cgc r 22 , 
cgvc r 3e > 



cgc r 3b > 
cgvc r 3 i 



cgc r 3e > 
cave r 3m 



cgcr3i, cacr3m, cgvcr22» 



t 
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eg vc r 3e 



cgvc r 3e 



NAME: 

cgvcr3e - curve given three points and ending slope 
SYNOPSIS: 

cgvcr3e(grh, x , y , ss ) 
float g, h , x ,y , se; 



DESCRIPTION: 



This routine draws a curve when given the 
coordinates of three points and the slope at the 
endpoint. The beginning point is defined by the present 
position of the beam. The intermediate point is shown 
by the coordinates g»h. The endpoint is defined by the 
coordinates x , y . The slope at the endpoint is given by 
se . 



g 

h 

x “ 

y 

se - 



x virtual 
y virtual 
x virtual 
y virtual 
slope of 



coordinate of 
Coordinate of 
coordinate of 
coordinate of 



i ntermedi at e 
i ntermed i at e 
the endpoint 
the endpo i n t 



the curve at the endpoint 



point 

point 



SEE ALSO: 



cgc r22 , 
cgvcr3br 



cgc r3b» 
cgvc r3i , 



cocr3e t 
cave r 3m 



cgc r 3 i , 



cacr3m, cgvcr22. 
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cgvc r 3 i 



cgvc r 3 i 



NAME: 

c a v c r 3 i ■ curve given three points and intermediate 
s 1 ope 

SYNOPSIS: 

cgvcr3i ( g , h , x , y , s i »se) 
float g/h,x,y,sir*se; 



DESCRIPTION: 



This routine draws a curve when given three points 
and the slope at the intermediate point. The beginning 
point is defined by the present position of the beam. 
The intermediate point is qiven by the coordinates g#h. 
The endooint is defined by the coordinates x > y . The 
slooe at the intermediate point is given by si. The 
address where the value of the ending slope will be 
returned is shown by se. 



g 

h 

X 

y 



x virtual 
y virtual 
x v i rtua 1 
y virtual 



coordi nat e of 
coordinate of 
coordinate of 
coordi nate of 



intermediate point 
intermediate point 
the endpoint 
the endpoint 



si - slooe of the curve at the intermediate point 



se - address of floating Doint variable where endina slope 
can be returned 



SEE ALSO: 

cacr2?» cacr3b» cqcr3e» cgcr3i, cacr3m, cavcr22* 
cgvcr3e* cgvcr3m 
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/ 



cgvc p 3m 



cgvc r 3m 



NAME: 

cgvcr3m - curve given three Points* one at the relative 
maximum 

SYNOPSIS: 

cgvcr3m(g*h,x,y,se) 
float g » h , x * y * *se J 



DESCRIPTION: 

This routine draws a curve when given three points 
where the slooe at the intermediate point is eoual to 
the slope of the chord joining the endooints. The 
beginning point is defined by the present position of 



the beam. 


The intermediate 


point 


i s 


shown 


by 


the 


coordi nates 


g t h . The endpo i n t 


i s 


defined 


by 


the 


coordi nates 


x*y. The address 


where 


the 


value 


o f 


the 



ending slooe will be returned is shown by se. 



g 

h 

x 

y 

se 



c an 



x virtual 
y virtual 
x virtual 
y v i r t ua 1 



coordinate 
coord i n a t e 
coordinate 
coord i nat e 



address of floating 
be returned 



of intermediate point 
of intermediate point 
of the endpoi nt 
of the endpo i nt 

point variable where ending slope 



SEE ALSO: 

cacr22, cgcr3b* cgcr3e* cocr3i* cgcr3m* covcr22* 
cgvcr3e* cgvcr3i 
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cqvdrwa 



cgvdrwa 



NAME: 

cqvdrwa - set orientation in virtual coordinates 
SYNOPSIS: 

cgvdrwa(s^a» r , x f / ac » a v ) 
i nt (*f)()rac»avfrj 
float S/3/x,y? 



DESCRIPTION: 



This routine resets the orientation then calls the 
user's function with the two arguements. Scaling is by 
means of the Conograph ic-12 hardware registers therefore 
limited to the range of 1/64 to 63 63/64. Upon return 
the previous orientation is restored. Thus the user is 
Drovided with a convenient means of recursively stacking 
the scale and offset settings. 

s - scale to be aDplied 



r • 



angle of desired rotation expressed in radians 
reflection desired 



0: 


no reflection 














1 : 


reflect 


about 


x - a x i s 












2: 


reflect 


about 


y - a x i s 












3: 


reflect 


about 


both axes t 


( d i 


rotation) 








4: 


reflect 


about 


o i / 4 line 












5: 


p i /2 rotation 


counterclockwise 








6: 


pi/2 rotation 


clockwise 












7: 


reflect 


about 


3/4 pi line 












- X 


v i r t u a 1 


coordinate which 


w i 


1 1 correspond 


with 


present beam 


position and be 


the 


center of 


reflect 


i on 


and 


rotation 
















- y 


v i r t ua 1 


coordinate which 


w i 


11 c o r respond 


w 


i t h 


present beam 


position and be 


the 


center of 


reflect 


i on 



and rotation 



f - user defined function 

ac - first arquement for user function 

av - second arquement for user function 
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SEE ALSO 



cqvdrwr, 



cadpawa, 



cadrawp 
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eg vd rw r 



cgvdrwr 



NAME: 

cgvdrwr - set orientation relative to present 
orientation in virtual coordinates 

SYNOPSIS: 

cqvdrwr(s,a, r , x , y , f / ac »av) 

int (*f )()fac f avf r?" float s / a / x / y ; 



DESCRIPTION: 

This routine sets a new orientation relative to the 
present orientation then calls the user's function. 
Thus the reflections^ rotations and scaling are 
cummulative. For best results it is recommended that 
most scaling factors be 1/ if the hardware scaling 
provided here is insufficient it is recommended that 
scaling be effected by utilizing another call to cgvcord 
(note: there is not automatic stackinq of cgvcord 

settings). Upon return the present orientation is 
restored. 

s - scale to be aoolied 

a - angle of desired rotation expressed in radians 
r - reflection desired 



0: 


no reflection 














1 : 


reflect 


about 


x - a x i s 












2: 


reflect 


about 


y-a x i s 












3: 


reflect 


about 


both axes/ 


( o i 


rot at ion) 






a: 


re f 1 ec t 


about 


o i /4 line 












5: 


oi/2 rotation 


counterclockwise 








6: 


pi/2 rotation 


c 1 o c k w i s e 












7: 


reflect 


about 


3 / 4 oi line 












- X 


v i r t ua 1 


coordinate which 


w i 


1 1 


correspond 


with 


present beam 


position and be 


the 


center of 


reflection 


and 


rotation 
















- y 


v i rtual 


coordinate which 


w i 


1 1 


cor respond 


with 


oresent beam 


oos i t i on and be 


the 


center of 


reflection 



and rotation 

f - user defined function 
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ac - first arauement for user function 
av - second arguement for user function 

SEE ALSO: 



cgvdrwa, cgdrawa» cadrawr 



cave 1 pq 



cgve 1 do 



NAME: 

cgvelpq - draw ellipse quarters in virtual coordinates 
SYNOPSIS: 

cgveloq(a/b,xefve»q»se) 
i nt q? 

float a r b r x e t ye , *se : 



DESCRIPTION: 

This routine draws the soecified number of quarters 
of an ellipse defined by its center and one endpoint of 
each axis. The ending slope is returned in se. Present 
beam position is taken as the enapoint of one axis and 
drawing starts in the direction of the other axis 
endpo i n t . 

a x virtual coordinate of center 

b y virtual coordinate of center 

xe - x virtual coordinate of other axis endpoint 

ye - y virtual coordinate of other axis endpoint 

q - number of additional auarters 
0: one quarter only 

1: semi-ellipse 

2: two additional Quarters^ total three quarters 

3: full ellipse 

se * address of floating ooint variable where endinq slope 
can be returned 



SEE ALSO: 

cgelosa> cgelpse, coelosa 
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cqv 1 i ne 



cgv 1 i ne 



NAME : 

cgv 1 i ne - line in virtual coordinates 

SYNOPSIS: 

eg v 1 i ne ( x » y ) 
float x , y ; 



DESCRIPTION: 

In this routine the beginning point is defined as 
the present position of the beam. The endpoint is 
defined by the coordinates x,y. 

x x virtual coordinate of the endpoint 

y y virtual coordinate of the endpoint 



SEE ALSO: 
eg 1 i ne 



sa 



cgvmove 



cgvmove 



NAME: 

cgvmove - move in virtual coordinates 

SYNOPSIS: 

cgvmove ( x , y ) 
float x f y t 

DESCRIPTION: 



This routine moves 
position without drawi nq 


* 


the 


beam 


to the 


indicated 


x virtual coordinate 


of 


the 


endpo i 


n t 




y virtual coordinate 


o f 


the 


endpo i 


n t 





SEE AbSO: 
cgmo ve 
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cow rmem 



cgwrmem 



NAME : 

cgw r mem ~ write to memory 

SYNOPSIS: 

cgw rmem ( b / n > w ) 
int b»n,*wJ 

DESCRIPTION: 

This routine writes the specified number of 
into the Conog raph i c - 1 2 font memory starting 
supplied base address. 

b - value to be loaded into the font base reqister 

n - number of words to be written 

w - array of at least size n where the words for 
are 



SEE ALSO: 
cgrdmem 



words 
at the 



memory 
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